home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / crccalcc / readme.txt < prev    next >
Text File  |  1998-08-12  |  3KB  |  69 lines
  1. CRC Calculation Control
  2. =======================
  3. (Turn wordwrap on)
  4.  
  5. Version        1.1
  6. Date           13/06/98
  7. Copyright (c)  Chris Amos, 1998
  8.  
  9. Introduction
  10. ~~~~~~~~~~~~
  11. This control (OCX) is really designed for VB4/5. It may work in other OCX containers but I haven't tried it.
  12.  
  13. The reason for using an OCX written in C for fairly simple algorythms are speed. In short the OCX is about 500 times quicker even if you are only adding up bytes (it also skirts around the bug in VB where a byte becomes a short int when you compile the application, but I digress...)
  14.  
  15. Usage
  16. ~~~~~
  17. In VB you simply give the OCX a string and say what CRC to return, you have the option of showing a progress bar or passing the string in chunks. An example VB project is included.
  18.  
  19. Installation
  20. ~~~~~~~~~~~~
  21. This is a programmers tool, if you need to ask...
  22.  
  23. License
  24. ~~~~~~~
  25. I have released this control as what I call 'swapware', this means you can use this control in any personal project for free (send me an email anyway for my intrest at freereg_crcocx@sirocco.force9.co.uk). I would like to get something back so if you use this control to produce a shareware or comercial product, I would like a copy of that product, DO NOT email me an application, send me an email with a description, a URL to get the program and the regcode etc. If it a big app that is only distributed on CD send me details and we'll take it from there. The address for swaps is swapreg_crcocx@sirocco.force9.co.uk
  26.  
  27. Support
  28. ~~~~~~~
  29. As this product is free, I will not guarantee to answer any queries, I, and a few others, have tested it and it does what I wanted. Send any queries to: freesupt_crcocx@sirocco.force9.co.uk
  30.  
  31. Source Code
  32. ~~~~~~~~~~~
  33. I understand that commercial organisations must be able to guarantee continuity of support if they choose to use a component especially from a one-man-band. The best way I can ensure this is to make the source code available. If you wish to 'buy' the source code go to www.sw-reg.com and look up product id 201692. They will send the password to open the source code archive (www.sirocco.force9.co.uk/crcsrc.zip) and inform me of your purchase. This will not guarantee I will provide support and upgrades etc, it is your guarantee that YOU can support the component.
  34.  
  35. Implementation
  36. ~~~~~~~~~~~~~~
  37. I have implemented a selection of CRCs detailed below:
  38.  
  39. 0: XOR
  40.    8 Bit Bitwise XOR
  41. 1: CRC32 
  42.    This is the most widely used CRC, it expressed as 
  43.    x^32,26,23,22,16,12,11,10,8,7,5,4,2,1,0. This is
  44.    used in zip archives.
  45. 2: Adler
  46.    I believe this is the method used in GZIP archives.
  47. 3: CRC16 
  48.    Fairly widely used CRC, it expressed as 
  49.    x^16,15,2,0.
  50. 4: CCITT
  51.    Its a standard, but I have no idea who uses it,   
  52.    16 x^16,12,5,0
  53. 5: 16 Bit Sum  
  54.    Simply adds up the bytes, way quicker than VB
  55.    and bug free. Sometimes called a longitudinal
  56.    redundancy check (LRC) in specs, but there must 
  57.    be more to something with a fancy name like that.
  58. 6: 32 Bit Sum
  59.    As 16 bit sum, but bigger.
  60. 7: Private Custom type
  61.    Please ignore this type.
  62.  
  63. History
  64. ~~~~~~~
  65. 1.0    Initial release, requires a 
  66.         progress bar control in VB proj 
  67.         that uses the control.
  68. 1.1    Fixed requirement for second 
  69.         progress bar.